home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / system / bbs / party.taz / party / installation < prev    next >
Encoding:
Text File  |  1992-12-23  |  4.5 KB  |  91 lines
  1. Installation of the party program version 2.5:
  2.  
  3. 1.  Edit the Makefile.  The following options are really important:
  4.         
  5.     BSD, SYSV or SYSIII should be set according to what most nearly
  6.     matchs your system.  If you want to mix and match, look at the
  7.     lower level options in party.h.  SunOS and Mach work fine as BSD.
  8.     SYSV has not been tested for a while.
  9.  
  10.         SUID or SGID should be set depending on if you are going to install
  11.     party running sgid to some group, or suid to some login.  The latter
  12.     has the advantage of making it possible to have "keeplog" channels
  13.     permitted only to certain groups by playing with the group permissions
  14.     of the log file.
  15.  
  16.     PARTYTAB should be set to the full path of the partytab configuration
  17.     file.
  18.  
  19.     There are also a lot of DFLT_* options you can set here.  These change
  20.     the compiled-in defaults for various options.  But since you can always
  21.     override any of these in the partytab, they aren't terribly critical.
  22.     But it is nice to have a sane set of compiled-in options.
  23.  
  24. 2.  Compile with a "make" command.
  25.  
  26. 3.  Install party in an appropriate bin directory.  It should be made suid
  27.     or sgid depending on the options described before.  Don't compile it
  28.     differently than you install it, or the log files will be created with
  29.     inappropriate permissions.
  30.  
  31. 4.  If you want to have multiple entries to party with different default
  32.     options, or starting in different channels, or in whole different
  33.     universes of channels, make a link to the party binary for each program
  34.     and add a line to the party tab starting with the link name and listing
  35.     all the options you like.  This file must be readable by party.
  36.  
  37.     Probably at a minimum you want to link it to "pwho" and add the line
  38.     "pwho userlist" to the partytab file.  The "pwho" command will then
  39.     list the users currently in party.  A sample partytab is included in
  40.     the distribution.
  41.  
  42. 5.  Make a chantab file (whose path name is given by the "chantab" option
  43.     which may be either compiled in or set in the partytab file).  Each line
  44.     of the starts with the name of a channel, and is followed by a list
  45.     of options for that channel.  You don't need to specify any options,
  46.     but having different options in different channels is more fun.  You
  47.     can use wildcard characters (* and ? and [..]) in the channel names.
  48.     Users may use any channel whose name matches any pattern in the chantab.
  49.  
  50.     Channels whose names don't have wildcards in them will be listed by
  51.     the ":list" command even if nobody is in them.  It is probably a good
  52.     idea to put the keeplog option only on these channels.  Normally the
  53.     last line of the chantab would just have the pattern "*", so that users
  54.     can use any channel name.  A sample chantab is included in the
  55.     distribution.
  56.  
  57. 6.  Create the log directory, whose name is given by the logdir option.
  58.     This directory must be writable by party.  You don't need to create
  59.     the log files unless you want them to have non-standard permissions.
  60.     Party will normally make log files itself, as needed.
  61.  
  62. 7.  Create the partytmp file.  This should initially be empty and be writable
  63.     and readable to party, but not to common users.  If you are upgrading to
  64.     a new version of party, emptying the partytmp file would probably be a
  65.     good idea.
  66.  
  67. 8.  Install the help file and the noisetab wherever you specified they
  68.     would be.  They need to be readable to party.
  69.  
  70. 9.  Put something in the crontab to restart each channel with the "keeplog"
  71.     option regularly.  This consists simply of removing the log files (or
  72.     mv'ing them to a backup place).  You don't need to create new files unless
  73.     you want them to have strange permissions.  Party will do that as needed.
  74.  
  75.     Note that if you don't give any channels the "keeplog" option, the you
  76.     don't have to bother with this.
  77.  
  78.     Log files for channels with "nokeeplog" set are supposed to be removed
  79.     when the last person leaves the channel.  This mechanism is not completely
  80.     reliable, mainly because people can "kill -9" their party processes,
  81.     which causes them to exit without giving party a chance to clean up after
  82.     them.  So you may find some "name.tmp" files in the log directory long
  83.     after everyone has left that channel.  Usually joining that channel and
  84.     leaving will cause it to be cleaned up.  But it would probably be a good
  85.     idea to include some command like 
  86.  
  87.         find <party-log-dir> -name \*.tmp -ctime +2 -exec rm -f {} \;
  88.  
  89.     in the cron's daily script to eliminate "nokeeplog" log files more than
  90.     two days old.
  91.